home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 090 / eq_part.arc / PARTNERS.DOC < prev    next >
Text File  |  1987-04-04  |  47KB  |  1,511 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.                               EQUAL PARTNERS
  22.  
  23.  
  24.                            Virtual disk system
  25.  
  26.                                Version 1.11
  27.  
  28.  
  29.  
  30.  
  31.                   K.eeping I.nformation S.haring S.imple
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.     "If you know DOS then you already know how to use Equal Partners."
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.          COPYRIGHT (c) 1985, 1986, 1987 by Downlink Systems Inc.
  53.          ALL RIGHTS RESERVED
  54.  
  55.  
  56.  
  57.      This document describes the EQUAL PARTNERS virtual disk  system,
  58.      version 1.11, which was created by Downlink Sys. in December of 1986.
  59.  
  60.  
  61.  
  62.                                   INTRODUCTION
  63.  
  64.  
  65.  
  66.      EQUAL PARTNERS is the copyrighted property of Downlink Sys. Inc.
  67.      You are granted a limited license to use , and to copy it and
  68.      distribute it, provided that the following conditions are met:
  69.  
  70.      1) No fee may be charged for such copying and distribution.
  71.  
  72.      2) EQUAL PARTNERS may ONLY be distributed in its original, unmodified
  73.         state.
  74.  
  75.      Contributions for the use of this program will be appreciated, and
  76.      should be sent -     payable to :  D. CONNER
  77.                           ------------------------
  78.  
  79.                              Downlink Systems Inc.
  80.                              c/o D. Conner
  81.                              1377 K. STREET N.W.
  82.                              SUITE 189
  83.                              WASHINGTON D.C.
  84.                                              20005
  85.  
  86.      You may not use this product in a commercial environment or a
  87.      governmental organization without paying a license fee of $40.
  88.      Site licenses and commercial distribution licenses are available.
  89.      A program disk and printed documentation are available for $40.
  90.      See the order form in the back of this manual for more details.
  91.  
  92.  
  93.      EQUAL PARTNERS is user supported software.  This means that you may
  94.      copy the shareware version freely and give the copies away to anyone
  95.      you wish, at no cost. They in turn are requested to send in a contri-
  96.      bution if they decide to use it.
  97.  
  98.      The user supported software concept (often referred to as shareware)
  99.      is an attempt to provide software at low cost.  The cost of offering a
  100.      new product by conventional means is staggering, and hence dissuades
  101.      many independent authors and small companies from developing and
  102.      promoting their ideas.  User supported software is an attempt to
  103.      develop a new marketing channel, where products can be introduced at
  104.      low cost.
  105.  
  106.      If user supported software works, then everyone will benefit.  The
  107.      user will benefit by receiving quality products at low cost, and by
  108.      being able to "test drive" software thoroughly before purchasing it.
  109.      The author benefits by being able to enter the commercial software
  110.      arena without first needing large sources of venture capital.
  111.  
  112.      But it can only work with your support.  We're not just talking about
  113.      EP here, but about all user supported software.  If you obtain a user
  114.      supported program from a friend or colleague, and are still using it
  115.      after a couple of weeks, then it is obviously worth something to you,
  116.      and a contribution should be sent. Upon receipt of a contribution,
  117.      you become a registered user and will receive a "full" feature, serial-
  118.      ized version of EQUAL PARTNERS.
  119.  
  120.                                    ii
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  I. WHAT IS EQUAL PARTNERS.
  127.  
  128.     Equal Partners is a software solution to the problem of sharing data
  129.   between 5 1/4 floppy based PC's and the new emerging convertibles
  130.   and lap-tops that use the 3 1/2 floppy drives and diskettes,
  131.   between different PC's with dissimiliar disk(ette) storage media,
  132.   or between different PC's with identical recording media!.
  133.  
  134.     Equal Partners addresses this problem by using inexpensive RS-232
  135.   serial adapters , software device drivers and communication programs
  136.   to attach the physical drives of one PC to the DOS operating system
  137.   of another PC. These physical drives become an extension of and to
  138.   the operating system of the other PC so that all DOS functions that
  139.   use a drive letter,to access data, function without concern that
  140.   these 'virtual' drives are not truly physically attached to the
  141.   floppy/hard disk controller cards.
  142.  
  143.  
  144.  II. WHY USE EQUAL PARTNERS
  145.  
  146.    Equal Partners provides a cost effective solution,as opposed to the
  147.   solution that IBM provides. IBM's solution is hardware based and
  148.   requires an additional out-of-pocket expense in the neighborhood
  149.   of $500.00. Equal Partners allows you to try its low cost solution
  150.   for a reasonable time. Then if you realize the cost savings, to
  151.   compensate the authors for their efforts and for your peace of mind.
  152.    We are sure you would rather use the $500.00 you saved, to invest,
  153.   expand and/or enrich your life in other ways.
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.                                     - 1 -
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  III. HOW DO YOU ACQUIRE USAGE RIGHTS TO EQUAL PARTNERS.
  189.  
  190.    Equal Partners is not totally free, a small contribution is asked
  191.   to allow the authors to feel that their efforts did not fall on
  192.   unfertile ground.
  193.  
  194.    The contribution can consist of several forms:
  195.  
  196.      FOR INDIVIDUALS
  197.      ----------------
  198.  
  199.         1.  Monetary
  200.             --------
  201.  
  202.             A registration and usage fee of $40.00 is asked, of
  203.           individuals. This will provide you with notices of
  204.           upgrades and fixes, as well as allow you access to
  205.           a version supporting additional com ports and faster
  206.           transfer speeds plus other additional features.
  207.  
  208.  
  209.          2). Personal
  210.              --------
  211.  
  212.             Another alternative , if money is a major negative
  213.           factor, is that we deeply request that you give a part of
  214.           yourself. Instead of a pound of flesh, a donation to your
  215.           local Red Cross of 1 pint of blood so that another may
  216.           'profit' from your 'gain'/'loss'. This is the least
  217.           contribution asked and expected.
  218.  
  219.  
  220.        FOR COMPANYS
  221.        ------------
  222.  
  223.           1) Monetary
  224.              --------
  225.  
  226.              For businesses, that benefit from additional utility
  227.            and time/cost savings, a per copy or site-license is
  228.            available and required. Otherwise, no usage license is
  229.            granted, and any use is strictly prohibited.
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.                                     - 2 -
  245.  
  246.  
  247.  
  248.  
  249.  
  250.   IV. HOW DO YOU USE EQUAL PARTNERS
  251.  
  252.  
  253.       First read the section on REQUIREMENTS, to see if your machine
  254.      and its hardware configuration can meet the necessary requirements.
  255.  
  256.       Secondly, install Equal Partners (see INSTALLATION section). Now the
  257.      easy part begins.
  258.  
  259.       You say, "nothing is ever easy". We say , "if you know DOS then you
  260.      know how to use Equal Partners".
  261.  
  262.       Granted you may not, yet, be a "POWER USER", but we bet you know how
  263.      to see whats on your disks, does the "DIR" command ring a bell. Now that
  264.      you know whats there, we also bet you got it there with the DOS "COPY"
  265.      command or someone did. Starting to catch on yet, we havent tried to
  266.      teach you any new convoluted commands with unfamiliar structure and
  267.      syntax , have we. Guess what!!. You have just graduated from the ACME
  268.      self study and enlightment course that certifies you as a "POWER USER"
  269.      of Equal Partners. Take a break, you deserve it. Oh, come back later
  270.      to get your EPPU 'certificate of achivement'.
  271.  
  272.       Back so soon?.
  273.  
  274.      Now to the serious business side of matters. You have all this data
  275.     , in some form or another, and you need to :
  276.  
  277.             consolidate/manipulate/share/archive/transport
  278.  
  279.     it between/among/with/to another/same media on another PC.
  280.  
  281.      Being a Equal Partners "POWER USER" (EPPU), you know that all you
  282.     have to do is use the DOS "COPY" command. So, do it, and give yourself
  283.     a pat on the back for a job well done.
  284.  
  285.      We could go on with how to use the other DOS commands, but we are
  286.     sure you are ahead of us already. What more can we say, in 25 words
  287.     or less, that would not confuse you. Again let us stress, if you
  288.     need to access data on the 'server' PC, just use the DOS commands
  289.     and the disk drive letters of the 'virtual drives' that are now
  290.     logically attached to your PC.
  291.  
  292.      Also, we are sure that you have guessed by now, that if you can
  293.     tell DOS where to get the data you need, for a program it should
  294.     be just as easy. Sure is, just 'tell' the program that the data it
  295.     needs is on one of the 'virtual drives' and business should
  296.     continue as always (unless that 'break-even' analysis formula
  297.     in the spreadsheet is in error).
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.                                     - 3 -
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  REQUIREMENTS
  313.  ------------
  314.  
  315.   The hardware requirements are:
  316.  
  317.  
  318.         1). Your machine must be an IBM PC/XT/AT or highly compatible,
  319.            including laptops and convertibles.
  320.  
  321.         2). The machine uses an 8250 uart,or compatible, to handle
  322.            the RS232C communications.
  323.  
  324.         3). The RS232C cable must have pins 2 and 3 crossed or
  325.            a straight thru cable with a null modem.
  326.  
  327.         4). The machine uses the port addresses at memory location
  328.            0:400. The port addresses are 03F8 for COM1, and 02F8
  329.            for COM2.
  330.  
  331.         5). The disk media must be Dos formatted, in other words
  332.            the boot sector must contain the BPB info that describes
  333.                            -------------------------
  334.            the media (the media type in the FAT is not used). Some
  335.            vendors that format their own disks do not bother to put
  336.            the BPB info in logical sector 0, even thought the Dos 3.2
  337.            Technical Ref. manual says that Dos will no longer rely
  338.            on the Media code in the FAT to determine the device
  339.            characteristics.
  340.  
  341.          6). As always, sufficient memory must be available.
  342.  
  343.  
  344.     The software requirements are:
  345.  
  346.  
  347.          1). The operating system must be PC Dos 2.0 or above.
  348.  
  349.              This product has been tested on PC DOS 2.0 , 2.1,
  350.             3.0, 3.1, 3.2 and 3.21.
  351.  
  352.          2). The PC DOS versions running on both the "server" and
  353.             the "remote(s)" SHOULD be identical!!.
  354.                             ------
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.                                     - 4 -
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  INSTALLATION
  375.  ------------
  376.  
  377.      Equal Partners consists of the following files:
  378.  
  379.         50-50.SYS       -  device driver
  380.  
  381.         EQUAL.COM       -  communication program
  382.  
  383.         PARTNERS.COM    -  communication program
  384.  
  385.         PARTNERS.DOC    -  this documentation
  386.  
  387.         SERVER.BAT      -  example batch file, with ERRORLEVEL checking
  388.  
  389.         REMOTE.BAT      -  example batch file, with ERRORLEVEL checking
  390.  
  391.         README.DOC      -  revision history and additional comments
  392.  
  393.         ????????.???    -  any additional files as the product matures
  394.  
  395.     Installation assumes two PC's, and the need to exchange data
  396.    between the PC's. One PC will be designated the 'server' PC
  397.    and the other PC(s) the 'remote' PC(s).
  398.  
  399.     The PARTNERS.COM program may be loaded on and is normally run
  400.    from the 'server' PC. The 'server' Pc could be considered the 'base'
  401.    PC in that it would normally contain all the master database and
  402.    spreadsheet programs and files. The 'remote' PC(s) could be lap-tops
  403.    that individuals had taken 'on-the-road' with them to gather data,
  404.    for updating to the 'server' databases..ect.
  405.  
  406.    So, installation on the 'server' of PARTNERS.COM consists of
  407.                     --------------
  408.  
  409.          1). Copying PARTNERS.COM to a directory in the DOS path,
  410.              and typing the command , 'PARTNERS' or including it in
  411.              a Dos batch file.
  412.  
  413.              Command format:
  414.  
  415.                PARTNERS [/COMx]
  416.  
  417.              where the parameter in "[]" is optional and indicates the
  418.             hardware port to use for communications. Replace the "x"
  419.             with "1" or "2" to override the installation default.
  420.  
  421.             Note: the "[]" are NOT part of the command!.
  422.  
  423.             Note: the install results may be tested in a batch
  424.                  file with the ERRORLEVEL statement.
  425.  
  426.  
  427.  
  428.  
  429.  
  430.                                     - 5 -
  431.  
  432.  
  433.  
  434.  
  435.    Now, installation on the 'remote' consists of
  436.                      --------------
  437.            1). Including the following command in 'CONFIG.SYS'
  438.  
  439.  
  440.                DEVICE=50-50.SYS  'z' additional disk drives requested
  441.  
  442.  
  443.                (where 'z' can be any number from 1 to 8, default=1)
  444.  
  445.  
  446.            2). Copying EQUAL.COM to a directory in the DOS path
  447.                and typing the command, 'EQUAL' or including it in
  448.                a Dos batch file.
  449.  
  450.              Command format:
  451.  
  452.                 EQUAL   [/COMx]
  453.  
  454.              where the parameter in "[]" is optional and indicates the
  455.             hardware port to use for communications. Replace the "x"
  456.             with "1" or "2" to override the installation default.
  457.  
  458.             Note: the "[]" are NOT part of the command!.
  459.  
  460.             Note: the install results may be tested in a batch
  461.                  file with the ERRORLEVEL statement.
  462.  
  463.     Once installed , any DOS command that would normally access data
  464.    using a drive designation, will be able to read/write data from
  465.    one PC to the other PC(s). What this means is that you can 'COPY',
  466.    , 'ERASE', 'RENAME', 'PATH', and execute programs to/on/from
  467.    the 'virtual' drives without any new commands or procedures.
  468.  
  469.  
  470.    If you know DOS then you already know how to use Equal Partners.
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.                                     - 6 -
  492.  
  493.  
  494.  
  495.  
  496.                                  RAMDISK SUPPORT
  497.  
  498.  
  499.  
  500.      If you have a RAMdisk, or other high-speed storage, then you can speed
  501.      up EP  somewhat by telling DOS to read from/write to the RAMdisk.
  502.      You do this by substituting the drive letter of the RAMdisk in all
  503.      the MS-DOS commands.  For example, if drive H: is your virtual RAMdisk,
  504.      then you would type:
  505.  
  506.          COPY H:*.*  D:
  507.  
  508.          (where D: could be a RAMdisk on your 'remote' PC)
  509.  
  510.      Refer to the MS-DOS manual for more details about the DOS commands.
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.                                     - 7 -
  553.  
  554.  
  555.  
  556.  
  557.                       PROGRAM  EXECUTION RESTRICTIONS
  558.  
  559.  
  560.  
  561.      If you are using a Shareware version of EQUAL PARTNERS, and have not
  562.      registered, then the following program execution restrictions
  563.      apply:
  564.  
  565.            1). Only 9,600 baud transfer rate is available.
  566.  
  567.            2). Only Com1 is supported.
  568.  
  569.            3). Only one virtual drive may be specified in
  570.                config.sys.
  571.  
  572.            4). Only reading is allowed, in otherwords you
  573.                may only copy data "from" the server. You
  574.                are not allowed to perform any Dos function
  575.                that would "write" to the server.
  576.  
  577.            5). The starting drive on the server is always the
  578.                "A:" drive. This means that the first virtual
  579.                drive assigned on the "remote" is the first
  580.                physical drive accessed on the "server".
  581.  
  582.  
  583.            6). Also some storage devices, such as a Bernoulli box,
  584.               may cause timing problems due to the fact that it may
  585.               require several seconds for the Bernoulli box to come
  586.               up to speed.
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.  
  611.  
  612.  
  613.                                     - 8 -
  614.  
  615.  
  616.  
  617.                               DISK DRIVE MAPPING
  618.  
  619.  
  620.  
  621.          This simple illustration shows how the drives and the letters
  622.        assigned are mapped to the physical vs. virtual drives.
  623.  
  624.  
  625.  
  626.  
  627.             'REMOTE'                                         'SERVER'
  628.  
  629.         +---------------+                                +---------------+
  630.         |  +---------+ o|                                |  +---------+ o|
  631.         |  |A:>dir C:| o|                                |  | Partners| o|
  632.         |  |         |  |                                |  |   v1.11 |  |
  633.         |  |Volume in|  |                                |  |Copyright|  |
  634.         |  +---------+  |                                |  +---------+  |
  635.         +---------------+                                +---------------+
  636.    +------------------------+                       +------------------------+
  637.    | IBM    o        o      |   Rs232  ----  cable  | IBM    +        o      |
  638.    |  PC    --=--    --=--  | ---------|  |---------|  PC    --=--    --=--  |
  639.    |                        |<--       ----         |                        |
  640.    +------------------------+  |                    +------------------------+
  641.               ^         ^      |        ^                      ^         ^
  642.               |         |      |        |                      |         |
  643.               |         |      |        |                      |         |
  644.           Physical  Physical   |      Null                 Physical  Physical
  645.           Drive A:  Drive B:   |     Modem                 Drive A:   Drive B:
  646.                                |
  647.                                |                               ^         ^
  648.                                |                               |         |
  649.                                |                               |         |
  650.                                |
  651.                                ------------------------->  Virtual   Virtual
  652.                                                            Drive C:  Drive D:
  653.  
  654.  
  655.      There may be Ramdisks on either or both the 'SERVER' and  'REMOTE'
  656.    PCs. Ramdisks are highly recommended, memory permitting, because this
  657.    eliminates all the mechanical delays that real hardware drives exhibit,
  658.    such as rotational delay, seek times and drive startup..ect.
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.                                     - 9 -
  675.  
  676.  
  677.  
  678.                              Usage Example NO. 1
  679.  
  680.  
  681.  
  682.          This simple illustration shows how EQUAL PARTNERS was used to
  683.        dial a remote BBS, with PCTALK III v7.00XA, and transfer data
  684.        to/from the "server" while BBS communications was maintained
  685.        on the "remote". This example was actual used by the authors.
  686.        We could also invision a BBS being run on the "remote" and the
  687.        "server" being used as non-dedicated aux. storage for the BBS.
  688.  
  689.  
  690.                 |
  691.                 | ^
  692.                 | |
  693.                 | --------- to phone line
  694.            +--------+
  695.            |  o o o | <----- external modem
  696.            +--------+
  697.                 |
  698.                 | Com2
  699.                 |
  700.                 |
  701.             'REMOTE'                                         'SERVER'
  702.  
  703.         +---------------+                                +---------------+
  704.         |  +---------+ o|                                |  +---------+ o|
  705.         |  |A:>PC-TAL| o|                                |  | Partners| o|
  706.         |  |         |  |                                |  |   v1.11 |  |
  707.         |  |         |  |                                |  |Copyright|  |
  708.         |  +---------+  |                                |  +---------+  |
  709.         +---------------+                                +---------------+
  710.    +------------------------+          Com1         +------------------------+
  711.    | IBM    o        o      |   Rs232  ----  cable  | IBM    +        o      |
  712.    |  PC    --=--    --=--  | ---------|  |---------|  PC    --=--    --=--  |
  713.    |                        |          ----         |                        |
  714.    +------------------------+                       +------------------------+
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.                                    - 10 -
  736.  
  737.  
  738.  
  739.                              Usage Example NO. 2
  740.  
  741.  
  742.          This simple illustration shows how EQUAL PARTNERS could be used
  743.        to collect data from various other PC's. As an example, lets say
  744.        that you are in the insurance business. Your company has an AT
  745.        in the home office and you have your agents out in the field
  746.        taking orders and collecting premiums. The agents were given
  747.        lap-tops , with 3.5 drives. Now you need to get the information
  748.        stored on the lap-tops to the AT to update the databases.
  749.  
  750.         The PARTNERS half of EQUAL PARTNERS could be activated on the
  751.       AT and as each agent comes in they just "plug" into the RS232
  752.       cable attached to the AT. PARTNERS, on the AT, does not care what
  753.       the other devices are on the end of the RS232 cable at any given
  754.       time. PARTNERS will automatically adjust to the drive character-
  755.       istics of what ever "remote" drive unit it reads. So, you can
  756.       "plug" into the cable attached to the AT, then when through,
  757.       "unplug" and "plug" in another "remote", whether it be a laptop
  758.       with 3.5 drives, a laptop with an internal harddisk, or PC/XT/AT
  759.       with a DOS formatted disk drive of some type.
  760.  
  761.                                 'SERVER'
  762.                             +---------------+
  763.                             |  +---------+ o|
  764.                             |  | Partners| o|
  765.                             |  |   v1.11 |  |
  766.                             |  |Copyright|  |
  767.                             |  +---------+  |
  768.                             +---------------+
  769.                        +------------------------+
  770.                        | IBM   +----+   --=--   |
  771.                        |  AT   |o   |   --=--   |
  772.                        |       +----+           |
  773.                        +------------------------+
  774.                                      |
  775.                                      |
  776.                                   +-----+
  777.                                   |     | <----- null modem
  778.                                   +-----+
  779.                                      |
  780.                                      |
  781.                                    mmmmm
  782.  
  783.  Agent "A"                                                             Agent "C"
  784.            wwwww                      wwwww                       wwwww
  785.              |                          |                           |
  786.      +-------------+             +-------------+             +-------------+
  787.      | +---------+ |             | +---------+ |             | +---------+ |
  788.      | |A:>COPY  | |             | |A:>COPY  | |             | |A:>COPY  | |
  789.      | |         | |             | |         | |             | |         | |
  790.      | |         | |             | |         | |             | |         | |
  791.      | +---------+ |             | +---------+ |             | +---------+ |
  792.      +-------------+             +-------------+             +-------------+
  793. +-----------------------+  +------------------------+  +-----------------------+
  794. | IBM convertible       |  | Zenith 181             |  | Toshiba 3100 +        |
  795. +-----------------------+  +------------------------+  +-----------------------+
  796.  
  797.                                    - 11 -
  798.  
  799.  
  800.                              Usage Example NO. 3
  801.  
  802.  
  803.          This simple illustration shows how EQUAL PARTNERS could be used
  804.        to share data among various PC's. This example shows a "server"
  805.        attached to a "switch box" by a RS232 cable. A switch box allows the
  806.        manual switching of internal connections between one "common" and
  807.        several other devices attached as "A","B","D" and "E" and such. The
  808.        devices are connected through "C" and what ever setting the physical
  809.        switch is pointing to. This arrangement could allow several PC's to
  810.        be attached to a "server" and data updated on the "server" or the
  811.        "server" used just to store the data prior to "switching" it to
  812.        another PC. The "server' does not have to be dedicated, only activat-
  813.        ed when actual data transfer is needed.
  814.  
  815.                                 'SERVER'
  816.                             +---------------+
  817.                             |  +---------+ o|
  818.                             |  | Partners| o|
  819.                             |  |   v1.11 |  |
  820.                             |  |Copyright|  |
  821.                             |  +---------+  |
  822.                             +---------------+
  823.                        +------------------------+
  824.                        | IBM   +----+   --=--   |
  825.                        |  AT   |o   |   --=--   |
  826.                        |       +----+           |
  827.                        +------------------------+
  828.                                      |
  829.                                      |
  830.                                 +--------+
  831.                                 |        | <----- null modem
  832.                                 +--------+
  833.                                      |
  834.                                      |
  835.                             +----------------+
  836.                             |        C       |
  837.                             |       /        |
  838.                             |      /         | <---------- Switch box
  839.                             |  a  b     d  e |
  840.                             +----------------+
  841.                                ^  ^     ^
  842.                    (a)         |  |     |        (d)
  843.              +------------------  |     ----------------------------+
  844.              |                    |                                 |
  845.              |                     +----+                           |
  846.              |                          | (b)                       |
  847.              |                          |                           |
  848.      +-------------+             +-------------+             +-------------+
  849.      | +---------+ |             | +---------+ |             | +---------+ |
  850.      | |A:>DBASE | |             | |A:>COPY  | |             | |A:>WORD  | |
  851.      | |         | |             | |         | |             | |         | |
  852.      | |         | |             | |         | |             | |         | |
  853.      | +---------+ |             | +---------+ |             | +---------+ |
  854.      +-------------+             +-------------+             +-------------+
  855. +-----------------------+  +------------------------+  +-----------------------+
  856. | IBM AT          --=-- |  | Zenith 181             |  | Toshiba 3100 +        |
  857. +-----------------------+  +------------------------+  +-----------------------+
  858.  
  859.                                    - 12 -
  860.  
  861.  
  862.  
  863.  
  864.                              PROGRAM UPDATE SERVICE
  865.  
  866.  
  867.  
  868.      A license to EP  entitles you to use all future Shareware versions. New
  869.      "restricted usage" versions are generally available through normal
  870.      freeware distribution channels, and we prefer that you obtain them that
  871.      way.
  872.  
  873.      A Program disk containing the latest version is returned on every
  874.      order of $40 or more.  If you wish to purchase a single-user license
  875.      and want an update disk, please enclose a check or money order for $40.
  876.  
  877.      For a fee of $50 per year you can subscribe to our program update
  878.      service.  Subscribers get up to five program updates per year mailed
  879.      to them as new versions come out.  This does not include trivial
  880.      releases.
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.                                    - 13 -
  921.  
  922.  
  923.  
  924.  
  925.                                  VERSION NUMBERS
  926.  
  927.  
  928.  
  929.      All of our version numbers are given as a number with two decimal
  930.      places.
  931.  
  932.      The units indicate a major revision, such as adding a new feature, maybe
  933.      such as virtual printer support.
  934.  
  935.      The first decimal place (tenths) indicates a minor revision that is
  936.      not essential, but which may be desired.
  937.  
  938.      The second decimal place (hundredths) indicates a trivial revision
  939.      that will probably only be desired by specific individuals or by die-
  940.      hard "latest version" fanatics.
  941.  
  942.  
  943.      To sum up: If the units change, then you should get the newer version
  944.      as soon as you can.  If the tenths change, then you may want to get
  945.      the newer version, but there's no hurry.  If anything else changes,
  946.      then you probably shouldn't bother.
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.                                    - 14 -
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  TECHNICAL REQUIREMENTS AND NOTES
  988.  --------------------------------
  989.  
  990.       Equal Partners uses the RS-232C hardware to interface the PC's and
  991.      provide the 'bridge' to allow the exchange of data.
  992.  
  993.       The hardware consists of the standard 8250 uarts and the DB-25
  994.      or DB-9 connectors and cables. However , only pins 2, 3, and 20,
  995.      are used. Also pins 2 and 3 are required to be crossed-over,
  996.      or you can build or purchase a modem eliminator/null modem.
  997.  
  998.      (See your local electronics parts dealer: such as RADIO SHACK)
  999.  
  1000.       This is the basic diagram of the CROSS-OVER pin configuration
  1001.  
  1002.  
  1003.                   'SERVER'               'REMOTE'
  1004.  
  1005.                    ------                 ------
  1006.                    |    |                 |    |
  1007.                    |  2 |--------------\ /|2   |  Pins
  1008.                    |    |               / |    |
  1009.                    |  3 |--------------/ \|3   |
  1010.                    |    |                 |    |
  1011.                    | 20 | ----------------|20  |
  1012.                    ------                 ------
  1013.                     DB-25                 DB-25
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.                                    - 15 -
  1044.  
  1045.  
  1046.  
  1047.      The following are notes and considerations both technical
  1048.     and otherwise, these must be noted and HEEDED:
  1049.  
  1050.          1). Both EQUAL.COM and PARTNERS.COM use COM1 or
  1051.              COM2 as the 'bridge'. The port addresses are
  1052.              disabled so that Basic will not interfere, as
  1053.              Basic tries to take over the com ports when
  1054.              loaded, even if does not need them. Com1 is
  1055.              only available for the shareware version.
  1056.  
  1057.               The program , 'PARTNERS.COM' will revector
  1058.              and restore the com ports addresses when it
  1059.              is de-actived however.
  1060.  
  1061.          2). The program ,'EQUAL.COM', installs resident and
  1062.            attaches itself to DOS, so that once installed its
  1063.            there to stay.
  1064.  
  1065.          3). The data transfer rate is 9,600 baud for the shareware
  1066.             version. Registered users may select rates up to 110,000
  1067.             baud.
  1068.  
  1069.          4). Error checking is performed on each block of
  1070.             data. Crc-16 is used to insure the integrity of
  1071.             your financial data and programs.
  1072.  
  1073.          5).  Ramdisks with sector sizes between 128 and 512
  1074.              bytes are supported. This applies to other disk
  1075.              media as well. The sector sizes must be a power
  1076.              of 2.
  1077.  
  1078.          6). The operating systems on ALL remote(s) and the server
  1079.             SHOULD/MUST be identical. Mixing DOS versions accessing
  1080.             the same data and media MAY/WILL cause problems. Some
  1081.             versions of DOS do not support media types made available
  1082.             in later versions of DOS, so some DOS utilities may not
  1083.             function correctly when accessing disk media or using
  1084.             function calls that were added/modified in later releases
  1085.             of DOS (ex: CHKDSK).
  1086.  
  1087.           7). Communication baud rates up to 110k are possible. However,
  1088.             going from 9.6 to 110+ will not give you 10 times the data
  1089.             transfer rate. The internal design of EQUAL PARTNERS allows
  1090.             for a matching of PC's with different cpu's , say a 4.77 mhz
  1091.             processor talking to a 16mhz processor. Obviously the 16 mhz
  1092.             beast could easily overrun the much slower 4.77 cpu.
  1093.               To allow for the possibility of mismatched processor speeds
  1094.             EQUAL PARTNERS turns the communications line around no faster
  1095.             than the slowest cpu can handle data. This means that going
  1096.             from 9.6 to 115k will send the data between PC's at that speed,
  1097.             but only as fast as the slower of the two Pc's can process and
  1098.             request more data from the faster processor.
  1099.               To achieve the expected higher data transfer rates at higher
  1100.             baud speeds, data compression is being tested and should be
  1101.             included in a later major release.
  1102.  
  1103.  
  1104.                                    - 16 -
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  Appendix A - Program Messages.
  1110.  
  1111.  
  1112.  
  1113.       All message text is preceeded by a formatted message code.
  1114.  
  1115.     The format of the message code is:
  1116.  
  1117.                   EPxNNNy
  1118.  
  1119.      where :
  1120.  
  1121.           x= 'D' - for 50-50.SYS  program output messages
  1122.  
  1123.              'E' - for EQUALS.COM program output messages
  1124.  
  1125.              'P' - for PARTNERS.COM program output messages
  1126.  
  1127.         and
  1128.  
  1129.  
  1130.           NNN= 000 thru 999, which is the message number for this
  1131.                             message type.
  1132.  
  1133.         and
  1134.  
  1135.           y= 'D' - for Dignostic type messages. These messages are
  1136.                   normally printed only if a critical error occurs
  1137.                   or the program is in a 'test' or debugging mode.
  1138.  
  1139.              'E' - for Error messages. These type messages indicate
  1140.                    that an unrecoverable error occured and the program
  1141.                    could not take any corrective action, except to
  1142.                    attempt to return to the DOS prompt.
  1143.  
  1144.              'I' - for Informative messages. These messages are just
  1145.                    to inform you  as to the processing state of the
  1146.                    program at any given time.
  1147.  
  1148.              'W' - for Warning messages. These messages indicate
  1149.                    that an error occured, but that the program
  1150.                    was able to take corrective action and continue
  1151.                    processing. However, the function the program was
  1152.                    attempting may or may not have been successfully
  1153.                    completed.
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.                                    - A1 -
  1167.  
  1168.  
  1169.  
  1170.       Message Code         Message text and its explanation
  1171.       ------------    ----------------------------------------------------
  1172.  
  1173.         EPD001I - EQUAL PARTNERS Virtual disk driver V1.11
  1174.                   (C)Copyright DOWNLINK SYS. INC. 1986
  1175.  
  1176.                   This is the copyright message displayed from the
  1177.                   virtual disk device driver during PC power-up.
  1178.  
  1179.         EPD002I - 1 virtual disk drive(s) available to DOS
  1180.  
  1181.                   This message indicates the number of additional
  1182.                   disk drives ('virtual') that DOS can access. These
  1183.                   drives may be accessed by the  DOS commands or any
  1184.                   program by using the drive letters assigned, by DOS,
  1185.                   to the virtual disks. Registered users may access up
  1186.                   to 8 virtual disks, the shareware version allows
  1187.                   access to only 1 virtual disk.
  1188.  
  1189.         EPE001E - installation cancelled - COM channel undefined
  1190.  
  1191.                   The program was trying to install, but was unable
  1192.                   to find a communications port address at the desired
  1193.                   memory location. The only recourse is to return to
  1194.                   DOS.
  1195.  
  1196.         EPE002E - installation cancelled - 50-50 driver not installed
  1197.  
  1198.                   The device driver, 50-50.sys, was not included in the
  1199.                   DOS file 'config.sys'. If your intent is to run this
  1200.                   PC as a 'remote', then see the INSTALLATION section
  1201.                   for the correct program configurations.
  1202.  
  1203.         EPE003E - installation cancelled - ALREADY installed
  1204.  
  1205.                   The program EQUAL.COM has already been installed once.
  1206.                   Multiple installations are not allowed.
  1207.  
  1208.         EPE000I - EQUAL activated - Communications link is COMx
  1209.  
  1210.                   This message relects that the installation of EQUAL is
  1211.                   in progess and that the Communications port, COMx, was
  1212.                   the port selected to link the "remote" to the "server"
  1213.  
  1214.         EPE001I - EQUAL installed - Virtual drives C: thru C: available for use
  1215.  
  1216.                   This is the most important type 'I' message that is
  1217.                   displayed.  This message reflects the  additional 'drive'
  1218.                   letters you use on all DOS commands and in programs, to
  1219.                   access data on the 'server' PC.
  1220.                      The drive letters displayed depends on the number of
  1221.                   virtual drives requested (up to 8 allowed) on the
  1222.                   'device=50-50.sys' statement in the DOS 'config.sys' file.
  1223.  
  1224.         EPE999I - EQUAL shutdown - returning to DOS
  1225.  
  1226.                   This message indicates that EQUAL.COM is returning to
  1227.                   DOS. See any additional messages for the exact reason.
  1228.  
  1229.                                    - A2 -
  1230.  
  1231.  
  1232.  
  1233.  
  1234.       Message Code         Message text and its explanation
  1235.       ------------    ----------------------------------------------------
  1236.  
  1237.  
  1238.         EPP001E - installation cancelled - COM channel undefined
  1239.  
  1240.                   The program was trying to install, but was unable
  1241.                   to find a communications port address at the desired
  1242.                   memory location. The only recourse is to return to
  1243.                   DOS.
  1244.  
  1245.         EPP002E - installation cancelled - EQUAL is already installed
  1246.  
  1247.                   The program is trying to be installed on a machine
  1248.                   that already has the EQUAL.COM program installed.
  1249.                   You can't make one machine both a 'remote' and a
  1250.                   'server'.
  1251.  
  1252.         EPP000I - PARTNERS activated - Communications link is COMx
  1253.  
  1254.                   This message relects that the installation of PARTNERS
  1255.                   is in progess and that the Communications port, COMx,
  1256.                   was the port selected to link the "server" to the "remote".
  1257.  
  1258.         EPP001I - PARTNERS installed -waiting for remote responce
  1259.  
  1260.                   You have entered PARTNERS from the Dos prompt or in
  1261.                   a batch file. PARTNERS is now installed (not resident)
  1262.                   and is waiting for RS-232 input on the communications port.
  1263.                   The programs EQUAL.COM and 50-50.SYS have to be installed
  1264.                   on the "remote" computer to complete the "bridge",so
  1265.                   that data may be freely transfered between computers.
  1266.  
  1267.         EPP999I - PARTNERS shutdown - returning to DOS
  1268.  
  1269.                   You have either pressed the 'ESC' key or installation
  1270.                   failed.
  1271.  
  1272.         EPP001W - Invalid I/O request - flushing input buffer
  1273.  
  1274.                   Extraneous or corrupted information was received. The
  1275.                   programs only recourse is to ignore the data, flush
  1276.                   all buffers and try to get in sync with the other PC.
  1277.  
  1278.         EPP001D - AX=      BX=     CX=    DX=
  1279.  
  1280.                   This message displays the internal register states.
  1281.                   The message is normally display only when a critical
  1282.                   error occurs or the programs debugging mode is active.
  1283.  
  1284.         EPP002D -     -
  1285.  
  1286.                   This message is preceeded by message code EPP001D.
  1287.                   Several additional message lines will be displayed
  1288.                   indicating the reason for this diagnostic message.
  1289.  
  1290.  
  1291.                                    - A3 -
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  Appendix B - Site License and agreement
  1297.  
  1298.  
  1299.  
  1300.                                   SITE LICENSE
  1301.  
  1302.  
  1303.  
  1304.      Corporate users may wish to obtain a site license for the use of EP.
  1305.      The site license applies only to one geographical area, not to exceed
  1306.      a 50 mile radius. Additional site licenses are required for each
  1307.      unique geographical location.
  1308.  
  1309.       Please use the order form in this manual to order a site license.
  1310.      Site licenses are granted when we receive your payment. License fees
  1311.      vary depending on the number of computers on which EP  will be used,
  1312.      as follows:
  1313.  
  1314.           1 to  9 copies  $40 each
  1315.          10 to 24 copies  $35 each
  1316.          25 to 49 copies  $30 each
  1317.          50 to 99 copies  $25 each
  1318.          over  99 copies  $3000 one time fee
  1319.  
  1320.  
  1321.  
  1322.      The following page is a site license agreement, which should be signed
  1323.      and sent with your payment when ordering a commercial site license.
  1324.  
  1325.  
  1326.  
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.  
  1333.  
  1334.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.                                    - B1 -
  1354.  
  1355.  
  1356.      The use of EP  in a commercial environment or government organization
  1357.      is granted under the following terms:
  1358.  
  1359.      1.  Payment of the license fee must be made payable to DOWNLINK SYSTEMS
  1360.         representative:                     ---------------
  1361.  
  1362.            D. Conner
  1363.            ----------
  1364.  
  1365.          The fee is based on the number of computers which will be used
  1366.          to run EP , as follows:
  1367.  
  1368.                1 to  9 copies  $40 each
  1369.               10 to 24 copies  $35 each
  1370.               25 to 49 copies  $30 each
  1371.               50 to 99 copies  $25 each
  1372.               over  99 copies  $3000 one time fee
  1373.  
  1374.      2.  You may use EP  on the number of computers included in the license
  1375.          fee.  If you have paid the fee for over 99 copies, then you may
  1376.          use EP  on any number of computers within your organization, within
  1377.          a given geographical area.
  1378.  
  1379.      3.  You may make copies of the program and documentation, in their
  1380.          original,  unmodified form. You may distribute these copies, within
  1381.          the limits of the number of copies licensed.
  1382.  
  1383.      4.  You may make copies of the program documentation, in both its
  1384.          printed form and machine readable form, without restriction.
  1385.  
  1386.      5.  You may use all future "restricted-usage" Shareware versions of EP
  1387.          under this license.
  1388.  
  1389.          The latest version is available from Downlink  for a small service
  1390.          charge.
  1391.  
  1392.      6.  You may NOT modify the program or charge a fee for copying or
  1393.          distributing the program or its documentation.
  1394.  
  1395.      7.  It is your responsibility to make the necessary copies and to
  1396.          deliver them to the computers which they will be used on.
  1397.  
  1398.      8.  We are not responsible for anything that may happen or not happen
  1399.          if you use EP.  You're on your own.
  1400.  
  1401.  
  1402.          I agree to abide by the terms and conditions of this license.
  1403.  
  1404.          _____________________________         __________________________
  1405.          Signature                             Date
  1406.  
  1407.          _____________________________
  1408.          Name (please print or type)
  1409.  
  1410.          _____________________________
  1411.          Title
  1412.  
  1413.          _____________________________
  1414.          Company
  1415.  
  1416.                                    - B2 -
  1417.  
  1418.  
  1419.  
  1420.  Appendix C - Ordering
  1421.  
  1422.  
  1423.                                    ORDER FORM
  1424.  
  1425.  
  1426.  
  1427.      Check which items you wish to purchase:
  1428.  
  1429.          (_) Noncommercial license for the use of EP.
  1430.  
  1431.          (_) Commercial license for the use of EP on ___ computers (see
  1432.              price schedule and terms on preceding page).
  1433.  
  1434.          (_) Program update subscription service (not more than five
  1435.              updates, does not include trivial changes), $50/year.
  1436.  
  1437.          (_) Payment of $_____ is enclosed (check or money order),
  1438.                 |
  1439.                 +------> payable to : D. CONNER.
  1440.                          ----------
  1441.  
  1442.              Signature: ________________________________
  1443.  
  1444.          _______________________________________________
  1445.          Name
  1446.  
  1447.          _______________________________________________
  1448.  
  1449.  
  1450.          _______________________________________________
  1451.          Address
  1452.  
  1453.          ______________________   ________  ____________
  1454.          City                     State     Zip
  1455.  
  1456.  
  1457.      Send check or money orders payable to : D. CONNER
  1458.  
  1459.      Send this completed form to:
  1460.  
  1461.                                   Downlink Systems Inc.
  1462.                                   c/o D. Conner
  1463.                                   1377 K STREET N.W.
  1464.                                   SUITE 189
  1465.                                   WASHINGTON D.C. 20005
  1466.  
  1467.  
  1468.      For program disk orders outside the U.S., please add an additional $5,
  1469.      and enclose an international money order payable in U.S. currency.
  1470.  
  1471.      For commercial site license orders, please enclose a signed copy of
  1472.      the site license agreement.
  1473.  
  1474.      Inquires for Corporate wide unlimited usage licenses are welcome.
  1475.  
  1476.  
  1477.  
  1478.                                    - C1 -
  1479.  
  1480.  
  1481.          ----------------end-of-author's-documentation---------------
  1482.  
  1483.                         Software Library Information:
  1484.  
  1485.                    This disk copy provided as a service of
  1486.  
  1487.                         The Public (Software) Library
  1488.  
  1489.                   Disks in the library are updated monthly.
  1490.          For a copy of the latest monthly software library newsletter
  1491.           and a list of the 800+ disks in the library, call or write
  1492.  
  1493.                         The Public (Software) Library
  1494.                                P.O.Box 35705 K
  1495.                            Houston, TX 77235-5705
  1496.                                (713) 721-6104
  1497.  
  1498.          We are not the authors of this program, nor are we associated
  1499.          with the author in any way other than as a distributor of the
  1500.          program in accordance with the author's terms of distribution.
  1501.  
  1502.          Please direct shareware payments and specific questions about
  1503.          this program to the author of the program, whose name appears
  1504.          elsewhere in  this documentation. If you have trouble getting
  1505.          in touch with the author,  we will do whatever we can to help
  1506.          you with your questions. All programs have been tested and do
  1507.          run.  To report problems,  please use the form that is in the
  1508.          file PROBLEM.DOC on many of our disks or in other written for-
  1509.          mat with screen printouts, if possible.
  1510.  
  1511.